home *** CD-ROM | disk | FTP | other *** search
/ Inside Mac Games Volume 7 #5 / IMG Vol 7-5.iso / Emulators / Mac TrueReality / Read Me < prev   
Text File  |  1999-07-27  |  17KB  |  245 lines

  1. Mac TrueReality - Read Me
  2. Tuesday, July 27, 1999
  3.  
  4. About the Program
  5. This program is a port of a Nintendo 64 emulator called True Reality for UNIX machines.
  6. With this program it is possible to play Nintendo 64 games on your own Power Macintosh computer, without any added hardware. You'll need to have one or more game images to play on Mac TrueReality.
  7. At the moment several commercial games will play, and a lot of demos work great.
  8. The emulator was ported to the MacOS by Gil Pedersen.
  9.  
  10.  
  11. The Menus
  12. File: Use this menu to load the game and quit the emulator.
  13. Prefs: You can enable & disable several option here.
  14.  •SpeedLimit: used to enable and disable Speed Limiting. This might be needed for some demos on very fast machines.
  15.  •FPS Counter: used to enable and disable the FPS Counter. If enabled a small fps counter will be displayed in the upper left corner of the screen.
  16.  •Microcode 0-3: used to select which microcode to emulate. Different games require this to be at different settings to work correctly. Check the compatibility list.
  17.  •Eeprom on/off: used to enable and disable the eeprom savegame support. Some games require this to be on, while other require it to be off.
  18.  •Wireframe: for displaying the 3d vectors regardless of other info in a simple mode.
  19.  •Ignore All Warnings: when enabled Mac TureReality won't display any errors in the emulation, and just silently continue (if possible).
  20. N64: This is for resuming the emulation, and resetting it.
  21.  
  22.  
  23. The Controls
  24. Mac TrueReality is using InputSprockets so the controls are completely configurable from that.
  25. Joysticks should work fine, and the mouse works as an analogue device too.
  26.  
  27.  
  28. Frequently Asked Questions
  29.  
  30. What does Mac TrueReality require?
  31. Mac TrueReality requires a PPC Macintosh, with a minimum of 32 MB RAM installed.
  32. A fast G3 is preferable, although it can run on slower computers too.
  33.  
  34. Because Mac TrueReality relies on DrawSprockets for resolution switching, you need to have DrawSprockets installed. Furthermore Mac TrueReality requires at least v1.2 of InputSprockets along with any relevant drivers.
  35.  
  36. The latest version of DrawSprockets & InputSprockets can be found at:
  37. http://til.info.apple.com/swupdates.nsf/artnum/n11167/
  38.  
  39. OpenGL from Apple does also need to be installed. You can get it from:
  40. http://www.apple.com/opengl/
  41.  
  42. If you have a 3dfx card, and wan't to have hardware accelaration of the graphics, the you can download and install the Mesa3dfxEnabler for OpenGL available at:
  43. http://www.mesa3d.org/mac/
  44.  
  45. If you want to use the enhanced open dialog, then you'll also need "Navigation Services" or MacOS 8.5 or later.
  46.  
  47. Lastly Mac TrueReality requires one or more game images, commonly referred to as "ROMs", in order to play anything.
  48.  
  49. Which games work?
  50. I've tested most of the games that work with the UNIX version. Currently the following games are known to work. There should be a lot more, though:
  51.  
  52. Demo list (not up-to-date):
  53. Pong - Perfectly playable! The speed is good too!
  54. Firedemo - Works fine.
  55. Rotate - Works fine.
  56. Sinus - Works fine. You have to wait a long time to see the wavy text.
  57. Fractal Zoomer - Works fine. Now it even displays the fractal.
  58. SP Crap - Works fine.
  59. Plasma Demo - Works fine.
  60. Hi_CFB - Works fine. Uses 640*480 graphics mode.
  61. Pause - Works fine.
  62. 77a - Displays first screen.
  63. Lightforce Demo - Works fine.
  64. Spice Rotate - Works fine.
  65. RPA - Works fine.
  66. Demo Tetris - Works perfectly.
  67. vNES - Starts up, shows 3 images and then the emulation stops.
  68. + a lot more
  69.  
  70. Commercial list (partial):
  71. Mario Kart 64 - Uses Microcode 1 -Emulationwise this game seems almost perfect. You can play the game itself, and the graphics are mostly positioned right. The only problem is the textures.
  72. Super Mario 64 - Uses Microcode 0 -Works great!!! Some texturing/color problems though.
  73. Wave Race 64(US) - Uses Microcode 2 -Works great!!! Some texturing/color problems though.
  74. Wave Race 64(J) - Uses Microcode 1 - Eeprom must be off!  -Works great!!! Some texturing/color problems though.
  75. Star Fox 64 - Uses Microcode 1 -Works great!!! Some texturing/color problems though.
  76. Bomberman 64 - Uses Microcode 1 -Works! Some texturing/color problems though.
  77. Bomberman Hero - Uses Microcode 1 -Works! Some texturing/color problems though.
  78.  
  79. Madden 64 - For some reason this game doesn't seem to work at the moment.
  80. Extreme G - For some reason this game doesn't seem to work at the moment.
  81.  
  82. Of games that displays intros I can mention (they might display more than the intro actually):
  83. Mystical Ninja
  84. Turok
  85. Clayfighter 63 1/3
  86. Bettle Adventure Racing
  87. Bust A Move 2
  88. Mortal Kombat Mythologies
  89. Mortal Kombat Trilogy
  90. Micro Machines Turbo 64
  91. + several games that display more or less interesting stuff
  92.  
  93. On a final note the following games don't work:
  94. The Legend of Zelda: Ocarina of Time
  95. Golden Eye 007
  96.  
  97. If you find any other games that work with Mac TrueReality, then please mail me about it.
  98.  
  99. Where can I get the games?
  100. There are several places where you can get legitimate demo game roms to test on Mac TrueReality. A couple of sites, which carry demo roms:
  101. http://www.blackbag.org/
  102. http://www.dextrose.com/
  103.  
  104. Don't mail me asking where to get commercial N64 ROMs.
  105. If you own a Nintendo 64 along with a backup unit, you can transfer your games to the computer and test them on Mac TrueReality. Or if you own the game, you can download it of the Internet.
  106.  
  107. Is there any way to make the games take up less space?
  108. Nintendo 64 games vary in size from 1.2 MB to 32 MB. Therefore I have implemented gzip support in Mac TrueReality, which means that you can compress you games with a gzip compression utility as Easy-Gz. This can shrink the size of the games down to about 60 KB, if it's one of the small demo games.
  109.  
  110. Why is it showing a black/garbled screen?
  111. This emulator is still not complete, and a lot of games still won't run on it. It is possible that you simply have to wait for the graphics to show up, as the emulation is very slow even on high-end machines. If it shows stuff, but the colours are incorrect, then it most likely because textures aren't implemented correctly yet.
  112. Alternatively you can try to change the microcode emulation to a different number.
  113. Note: Because the graphics doesn't look right doesn't mean that there is something wrong with your computer. 3D graphics are still in the progress of being implemented, and often don't look right.
  114.  
  115. Why did it suddenly stop and pop up a dialog?
  116. This happens when Mac TrueReality encounters an un-emulated instruction. This means that the game isn't emulated propperly yet. You now have the option to ignore this, and continue the emulation, as though nothing had happened. If you don't care to see this dialog again, then just press the ignore all button.
  117. Note: A lot of games still work even though errors appear. All commercial games displays errors at the moment.
  118.  
  119. Mac TrueReality gives me out of memory errors?
  120. This is because the game you have selected is to large to copy into the available memory. Either load another smaller game or make sure that there is 24 MB of free memory before launching Mac TrueReality. If the game is larger than 144 MBit (for example Zelda 64), then you'll have to increase the amount of memory allocated to Mac TrueReality.
  121. Be carefull not to give Mac TrueRelality too much memory. There should be at least 4 MB available to the system when you open Mac TrueReality. Otherwise Mac TrueReality will quit immediately, without warning.
  122.  
  123. Mac TrueReality won't open. What is wrong?
  124. Mac TrueReality now uses OpenGL. OpenGL requires there to be at least 4 MB of free system memory to function. OpenGL is inited at startup, and if there isn't the neccesary memory available it won't start up, and Mac TrueReality will quit. At the moment there's no error dialog explaining this.
  125. If you experience this kind of problem, then you can try to quit any unneccesary open programs to free up memory, or reduce the memory allocation for Mac TrueReality. If you reduce the memory allocation, then some of the bigger games might not open, because they need a lot of memory.
  126.  
  127. The games play really slow, like 2-3 fps. Is this normal?
  128. Yes, speeds of around 2-3 fps is not unnormal. Unless you have a Blue & White G3 or a fast iMac (at least rev. B) then it is perfectly normal. In future versions the speed will hopefully improve.
  129.  
  130. Version History
  131.  
  132. • 27.07.99
  133.  - A major bug in the last release is now fixed. The bug caused all 3D graphics to not get displayed on many machines.
  134.  - Slight graphics improvement. The text should now be easier to read in Mario 64.
  135.  - Enhanced Open Dialog(Navigation Services Only). Now it only displays N64 games.
  136.  - Slight speed increase due to a cpu emulator optimisation and the fact that Mac TrueReality is now compiled with CodeWarrior 5.
  137.  - Improved savegame handling. Now only games that use the eeprom saves the data.
  138.  - (Miklós Fazekas) Added support for Mesa3dfxEngine.
  139.  - (Gabrielle Harrison) Added an option to never display error warnings(default).
  140.  
  141. • 05.07.99
  142.  - It seems that there was several serious bugs in the last release, and I've fixed at least some of them, so that Mac TrueReality will be more stable.
  143.  - The graphics have been improved quite a bit in this new release, especially in Super Mario 64, where the graphics are now almost perfect (well good enough to be playable, except the non-transparent water).
  144.  - "Bomberman Hero" should work now, although there are graphics bugs.
  145.  - "Mario Kart 64" really works now. I had introduced a bug that made it not work, just before release and I didn't notice untill it was too late.
  146.  - Added support for saving the eeprom. This allows for "Super Mario 64" and other games to load & save games. The data is saved in a file called "romname.epp" where romname is the name of the game. Currently all games will create an "*.eep" file, although they don't use the eeprom. It even works with savegames dumped with copiers or downloaded from the Internet. You just have to give the file the right name. If the size of the save is over 1K (1024 bytes) it won't work yet.
  147.  - Now all that is needed for "Super Mario 64" to be truly playable is speed!
  148.  
  149. • 01.07.99
  150.  - It has been a long time since the last version of Mac TrueReality was released, but I hope it was worth the wait. Finally commercial Nintendo 64 games can be played on MacOS computers.
  151. At the moment several commercial games are known to be playable, but in a lot of other games you can get pretty far before the emulation stops for one reason or another.
  152. Not only commercial games work, but a lot of new demos work too. You can check the compatibility list to see the status of some of the tested games.
  153.  
  154.  - A new "Prefs" menu with several options has been added. The preferences doesn't get saved yet.
  155.  
  156.  - A Microcode selector is now available in the "Prefs" menu. This is for choosing which version of the N64 microcode that should be emulated with High Level Emulation (HLE).
  157. Most demos/demogames work with the "Microcode 0". Most commercial games need the "Microcode 1", except "Mario 64" which uses "Microcode 0" and Wave Race 64(US) which uses "Microcode 2". You can change the microcode while the game is running, and all that it effects is the display of 3D graphics.
  158.  
  159.  - Another new option is the "Eeprom on/off". At the moment this doesn't do much, but some games might require it to be either on or off. The eeprom is used for saving information, but as Mac TrueRelaity doesn' save this information to the Harddisk, then there is not much point in this.
  160.  
  161.  - Framerate display has been added, although at the moment it isn't calculated correctly. Instead it's more of a display of how fast the emulation is.
  162.  
  163.  - A speed limiter has been added, as a few demos actaully run too fast on my computer. There should be more use for it once Mac TrueReality has a dynamic recompilation cpu core.
  164.  
  165.  - An option to continue the emulation, even after an unemulated instruction has occured, has been added. A dialog will pop up when such an instruction occurs. Simply press ignore if you want to continue. This is required for most commercial games to work at the moment, and often makes the games display something more.
  166.  
  167.  - As you might have noticed Mac TrueReality has got a new set of icons, which has been made by JC Capp. Nice stuff!
  168.  
  169.  - Instead of RAVE support, there is now support for OpenGL. All the 3D graphics are rendered using OpenGL. Textures aren't implemented properly yet, so some things might look weird.
  170. You will need to have OpenGL from Apple installed on your computer in order to play Mac TrueReality. I'll add MesaGL support too in a future version, so that 3dfx users can get hardware acceleration of 3D graphics too.
  171.  
  172.  - Ernesto Corvi has worked on adding audio support to Mac TrueReality, and he did a good job. Unfortunately there seems to be a bug in the MetroWerks compiler, which will make the computer crash when Audio emulation is enabled. Therefore it isn't enabled untill a fix has been found.
  173.  
  174. • 17.03.99
  175.  - It been quite a while since the last update, and I wish that I could tell you that Mac TrueReality had progressed more than it actually has.
  176.  
  177.  - Work has now been begun on adding RDP support, which is what we need for 3D graphics. So far only a couple of 2D instructions are partially implemented. Only one demo is known to display new graphics. It is the Tetris demo.
  178.  
  179.  - Changed the way the mouse works in the games. This seems to be better in pong at least.
  180.  
  181.  - RAVE support is not ready to be included yet. It will have to wait for the next release.
  182.  
  183.  - I suppose some new demos are working now. I don't know which, though.
  184.  
  185. • 07.01.99
  186.  - RSP/RCP emulation has progressed, but there stills needs to be emulated more instructions for games to work.
  187.  
  188.  - Basic sound emulation has been added to the unix port, but I haven't implemented it into the MacOS port yet. I'll possibly add it to the next version.
  189.  
  190.  - Really fixed that Firedemo bug. I didn't test the last version of Mac TrueReality before releasing it and afterwards I discovered that Firedemo wasn't working properly as I had promised. Turned out to be a compiler bug, when a certain optimization was enabled.
  191.  
  192. • 13.12.98
  193.  - Switched over to using InputSprockets for input, as otherwise it would be impossible to have 2-player support, where both players could use an analog device, such as a mouse or joystick. This means that Mac TrueReality now requires InputSprockets.
  194.  
  195.  - Removed the dependensy of Appearance Manager, which means that Mac TrueReality doesn't need Apple's Appearance Manager to run.
  196.  
  197.  - Speed has increased dramatically in Pong, and maybe other games too.
  198.  
  199.  - Fixed the bug, that caused Firedemo not to work. This bug actually affected other games too. This means that Mac TrueReality can now run more demos, and that soon commercial games might start working!
  200.  
  201.  - Work on RSP/RCP emulation has begun, which is essential for making commercial games run.
  202.  
  203.  - Sound emulation is also progressing, although I don't think that Mac TrueReality can run any game, which plays sound. I haven't worked on adding it to the MacOS port of TrueReality yet.
  204.  
  205.  - As more of the cpu is emulated more demo's are now working.
  206.  
  207.  - Added a pause function. This will pause the emulator completely, and as it is right now, you have to unpause the game before you can press escape, and return to the regular interface.
  208.  
  209.  - Added a screenshot function, which will save the current screen image onto a file.
  210.  
  211.  - More stuff that I can't remember.
  212.  
  213. •    21.10.98
  214.  - Updated the emulator with the new 1998211001 Linux sources. This means that the colours should now be correct.
  215.  
  216.  - There has also been added improved controller support, which means that you'll now be able to actually play pong! See control section for more info. I'll add more keys as needed.
  217.  
  218.  - A preference menu has been added, which allows you to select whether you are going to use the mouse/joystick for analog movement, or the keyboard. This preference won't be saved yet.
  219.  
  220. •    07.09.98
  221.  - Initial release.
  222.  
  223. Contact Information
  224. If you have any questions, comments, suggestions or bugs you want to report then please feel free to contact me.
  225.  
  226. Gil Pedersen
  227. Email: gil@mailme.dk
  228. ICQ: 13683696
  229.  
  230. Mac TrueReality homepage:
  231.   http://mtr.dht.dk/
  232. or
  233.   http://www.emuhq.com/truereality/macos/
  234.  
  235. Original True Reality homepage:
  236.   http://www.emuhq.com/truereality/
  237.  
  238. Thanks
  239. A special thanks goes to JC Capp who has given Mac TrueReality a set of new icons.
  240. I'd like to thank Ernesto Corvi too, who have made Mac TrueReality support audio output in demo games.
  241. Thanks also goes to Richard Bannister<titan@indigo.ie>, who made me begin porting TrueReality and for helping me along the way. And a thanks goes to Ben Mackin<Kupan787@aol.com>.
  242.  
  243. I'd also like to thank Niki Waibel, the creator of the original TrueReality for UNIX, without who's work on emulating a Nintendo 64, there would not have been any Nintendo 64 emulator for the MacOS.
  244.  
  245. Also thanks to all the beta testers, who have tested my different versions of Mac TrueReality.